home *** CD-ROM | disk | FTP | other *** search
/ Aminet 25 / Aminet 25 (1998)(GTI - Schatztruhe)[!][Jun 1998].iso / Aminet / comm / bbs / Sys_InfoV2.lha / Sys_Info / Sys_Info.Doc < prev   
Text File  |  1998-03-07  |  6KB  |  177 lines
  1.  
  2.        ______                __
  3.       / ____/              _/ /_
  4.      / /___ __  __ ______ /  __/______ _   _
  5.     /___  / \ \/ // ____/ / /  / ____// \_/ \
  6.    ____/ /   \  /_\__  / / /_ / __/_ / /__/ /
  7.   /_____/    / //_____/ /___//_____//_/  /_/
  8.             /_/
  9.        ______                                            __   __
  10.       /_  __/                                          _/ /_ /_/
  11.        / /  ______ ______ ______ _____ _   _   ______ /  __/__   ______ ______
  12.       / /  / __  // ____// __  // .__// \_/ \ / __  / / /  / /  / __  // __  /
  13.    __/ /_ / / / // __/  / /_/ // /   / /__/ // __  / / /_ / /_ / /_/ // / / /
  14.   /_____//_/ /_//_/    /_____//_/   /_/  /_//_/ /_/ /___//___//_____//_/ /_/
  15.  
  16.                               By Thomas Newsom
  17.  
  18. Sys_Info is good old fashioned PUBLIC DOMAIN software. Yes, you can use it
  19. totally free of charge! But I retain the copywrite of the source code.
  20.  
  21. Disclaimer
  22. ----------
  23.  
  24. You use Sys_info at your own risk. The author will not be held responsible
  25. if anything should happen to your computer whilst running Sys_info.
  26.  
  27. Version.
  28. --------
  29.  
  30. 0.5        : Internal release.
  31. 0.7      : Started adding the display setups
  32. 0.9      : first working version without bugs :-)
  33. 1.0      : First version released for beta testing.
  34. 1.2      : Added 'Section' display headers. Cleaned up display a little.
  35. 1.5      : Added 'System Setup' selectable option
  36. 1.6      : Added version string (why do I always forget this until last!)
  37. 1.8      : Tidied the code up (again)
  38. 2.0      : Now uses a cfg file fully definable by the user.
  39. 2.?      : Will probably never appear :-(
  40.  
  41. Beta Testers
  42. ------------
  43.  
  44. Lee Dyson
  45. Trevor Smith
  46.  
  47. Thanks to them both for testing this program :-)
  48.  
  49. Registered Users
  50. ----------------
  51.  
  52. Lee Dyson, Trevor Smith, Dale Frameli
  53.  
  54. Due to the slow response (I'll give it a month as of now) to this program I
  55. doubt I can be bothered to write any more doors/utils for general usage.
  56. I'll keep them to myself.
  57.  
  58. Thank you for your total lack of support.
  59.  
  60. Contact.
  61. --------
  62.  
  63. Email    : Thomas.Newsom@allhours.karoo.co.uk
  64. FidoNet  : 2:2502/61.0 & 2:2502/59.0
  65. Amnet    : 69:103/21.0 & 69:103/22.0
  66. AmigaNet : 39:134/13.0 & 39:134/14.0
  67. BlackNet : 167:482/6.0
  68.  
  69. For contact use the E-Mail address as thats fastest and sure to get a reply
  70. quicker than any other route.
  71.  
  72. Registration
  73. ------------
  74.  
  75. To register Sys_Info simply send me an E-mail with your REAL name in it and
  76. I'll send you a keyfile ASAP in UUEncoded format.
  77.  
  78. What is this thing then?
  79. ------------------------
  80.  
  81. Really, it's nothing special. All it does is display some system information
  82. such as the libraries in use, the number of tasks running etc etc.
  83.  
  84. As from V2.0 you now use a configuration file to define which commands are
  85. available and which are not. Due to the way the configuartion file is laid
  86. out, you could now use Sys_Info to display all manner of things.
  87.  
  88. Explaination of the configuration file layout
  89. ---------------------------------------------
  90.  
  91. This is the heart of V2.0 with this cfg file the possiblities of what you
  92. can show your users is almost unlimited. Be aware though that the program
  93. you specify as the the one to be run must give the result to the shell. If
  94. you don't allow for this then that function will not be much use and will
  95. probably crash the program.
  96.  
  97. The layout is very simple but worth explaining as
  98. some errors could occur if not careful.
  99.  
  100. Each online command has 3 lines in the conguration file...
  101.  
  102. Line 1 is the letter command to be seen onscreen by the user.
  103. Line 2 is the FULL path to the program to be executed.
  104. Line 3 is the text displayed to the user along side the letter command.
  105.  
  106. The next 3 lines belong to the next command, the 3 lines after that belong
  107. to the next command and so on...
  108.  
  109. Here is a section from the default configuration given with this archive..
  110.  
  111. A
  112. doors:sys_info/AboutCLI
  113. Information about the currently used SHELL
  114. B
  115. doors:sys_info/execdevs
  116. Information on currently loaded DEVICES
  117. C
  118. doors:sys_info/execIrupts
  119. Information on currently loaded INTERRUPTS
  120.  
  121. And so on for the rest of the commands.
  122.  
  123. The last 6 lies of the configuration files SHOULD ALWAYS BE THE FOLLOWING 6
  124. LINES....
  125.  
  126. Q
  127. @
  128. Exit.
  129. Z
  130. @
  131. Information on THIS PROGRAM"
  132.  
  133. As you can see it's very flexible.
  134.  
  135. WARNING!!!!!!!!!!!!! THESE MUST ALWAYS BE THE LAST 6 LINES OF THE
  136. CONFIGURATION FILE OTHERWISE VERY STRANGE RESULTS, PROBABLY LEADING TO A
  137. TOTAL SYSTEM CRASH, WILL OCCUR.
  138.  
  139. You have been warned :-)
  140.  
  141.  
  142. Installation?
  143. -------------
  144.  
  145. I didn't bother writing an installer script for this as it's too easy to
  146. do......No really :)
  147.  
  148. You've already unarced the archive (how else are you reading this?) so all
  149. you have to do now is copy the entire Sys_Info directory to your doors
  150. assigned directory.  In the Sys_info directory there is one library,
  151. akccplus.library, copy that to your LIBS assigned directory.  
  152.  
  153. Now load the Sys_Info.cfg file within that directory into your favourite
  154. text editor and if required edit it to your liking. Sys_Info can be run as a
  155. normal Shell program so you can see the results before allowing your users
  156. access to the program. If it shows odd results in the Shell then reread the
  157. bit above about the cfg file and check yours out.
  158.  
  159. Thats it! It's now installed ready for use.
  160.  
  161. How you set it up on your BBS system depends on which system you are using.
  162. The only thing you have to bear in mind is that Sys_Info is hardcoded to
  163. look in Doors:Sys_Info/ for it's files.
  164.  
  165. One of the options in Sys_Info requires the C= ShowConfig program.  You MUST
  166. have this in your path settings.
  167.  
  168. Important notice.
  169. -----------------
  170.  
  171. Sys_Info uses some of the AKCC programs.  The author of the AKCC suite gave
  172. me permission to use his programs.  Please read the AKCC.Readme file held in
  173. the Sys_Info directory.
  174.  
  175. My thanks go out to the AKCC author Andreas R. Kleinert.
  176.  
  177.